Danh sách token cơ hội
Mô tả API
Lấy danh sách token mà AI theo dõi qua dữ liệu đa chiều, có tiềm năng tăng giá trong điều kiện thị trường hiện tại.
Tình huống sử dụng:
- Lọc và truy vấn token có cơ hội tăng giá trong điều kiện thị trường hiện tại
- Nhà giao dịch trung-hạn ngắn hạn tìm token có tiềm năng tăng giá
- Nhận diện cơ hội tăng giá tiềm năng trong chiến lược theo dõi xu hướng
Gợi ý sử dụng:
- Khi người dùng nhập tự nhiên các từ như đầu tư trung-dài hạn, cơ hội tăng giá, tăng giá, lợi nhiều, v.v., có thể truy vấn API này
- Khi người dùng nhập tự nhiên cơ hội tăng giá, token tăng giá, v.v., có thể truy vấn API này; kết quả trả về cần ghi rõ token giám sát cơ hội tăng giá
Tần suất cập nhật dữ liệu: mỗi 5 phút
URL yêu cầu
- Phương thức:
POST - Đường dẫn:
/open/v1/ai/getChanceCoinList
Tiêu hao điểm tích lũy
- Điểm tích lũy mỗi lần gọi:
6
Điều kiện tiên quyết
Không có điều kiện tiên quyết; có thể gọi trực tiếp.
Tham số yêu cầu
Truyền tham số trong body dưới dạng JSON.
Không có tham số yêu cầu.
Trường phản hồi
Chỉ liệt kê cấu trúc trường trong từng phần tử của mảng data:
| Trường | Kiểu | Kiểu thực tế trả về | Mô tả |
|---|---|---|---|
| vsTokenId | long | string | Token ID |
| symbol | string | string | Ký hiệu token |
| price | number | string | Giá hiện tại (USD) |
| maxPrice | number | string | Giá cao nhất lịch sử (USD) |
| minPrice | number | string | Giá thấp nhất lịch sử (USD) |
| percentChange1h | number | string | Phần trăm thay đổi giá 1 giờ |
| percentChange24h | number | string | Phần trăm thay đổi giá 24 giờ |
| percentChange7d | number | string | Phần trăm thay đổi giá 7 ngày |
| percentChange30d | number | string | Phần trăm thay đổi giá 30 ngày |
| percentChange60d | number | string | Phần trăm thay đổi giá 60 ngày |
| percentChange90d | number | string | Phần trăm thay đổi giá 90 ngày |
| cost | number | string | Giá chi phí vốn chủ lực (USD) |
| costChange | number | string | Tỷ lệ thay đổi chi phí |
| deviation | number | string | Độ lệch giá (%) |
| marketCap | number | string | Vốn hóa thị trường (USD) |
| marketCapRanking | integer | integer | Xếp hạng vốn hóa |
| circulatingSupply | number | string | Lượng cung lưu hành |
| circulationRate | number | string | Tỷ lệ lưu hành (%) |
| active | integer | string | Số địa chỉ hoạt động 24h |
| newly | integer | string | Số địa chỉ mới 24h |
| tradeType | integer | integer | Loại giao dịch (1: Spot 2: Hợp đồng 3: Hợp đồng giao hàng) |
| chanceCoinTradeDataV1Vos | array | array | Danh sách dữ liệu giao dịch theo thời gian |
| timeRange | string | string | Mã khoảng thời gian (ví dụ m15, H4) |
| timeParticleEnum | integer | integer | Giá trị enum độ chi tiết thời gian |
| tradeInflow | number | string | Số tiền dòng tiền ròng giao dịch (USD) |
| tradeAmount | number | string | Tổng số tiền giao dịch (USD) |
| updateTime | long | long | Thời gian cập nhật (timestamp mili giây) |
| pushPrice | number | string | Giá đẩy vào lệnh (USD) |
| pushMaxPrice | number | string | Giá cao nhất sau khi đẩy (USD) |
| gains | number | number | Mức tăng sau khi đẩy (%) |
| pushMinPrice | number | string | Giá thấp nhất sau khi đẩy (USD) |
| declines | number | number | Mức giảm sau khi đẩy (%) |
| score | number | number | Điểm tổng hợp AI |
| scoreChange | number | number | Thay đổi điểm |
| grade | integer | integer | Cấp cơ hội |
| alpha | boolean | boolean | Có tín hiệu Alpha hay không |
| fomo | boolean | boolean | Có trạng thái FOMO hay không |
| fomoEscalation | boolean | boolean | Có FOMO leo thang hay không |
| bullishRatio | number | number | Tỷ lệ tâm lý tăng giá |
| bearishRatio | number | number | Tỷ lệ tâm lý giảm giá |
Ý nghĩa nghiệp vụ
Các trường sau cần giải thích rõ ý nghĩa nghiệp vụ và logic tính toán:
| Trường | Ý nghĩa | Phạm vi / Cách tính | Gợi ý sử dụng |
|---|---|---|---|
| cost | Giá chi phí vốn chủ lực | Chi phí nắm giữ vốn chủ lực tính theo trọng số giao dịch lớn | Khi giá hiện tại thấp hơn giá chi phí có thể là cơ hội mua |
| deviation | Độ lệch giá | (Giá hiện tại - Chi phí vốn chủ lực) / Chi phí vốn chủ lực * 100% | Giá trị âm nghĩa là thấp hơn chi phí, giá trị dương nghĩa là cao hơn chi phí |
| score | Điểm tổng hợp AI | Phạm vi 0-100, tính tổng hợp từ dòng vốn, chỉ báo kỹ thuật, v.v. | Điểm <= 45 hoặc >= 80: token chờ quan sát; 45 < điểm < 55: token quan sát; 55 < điểm < 80: token cơ hội |
| grade | Cấp cơ hội | Phạm vi 1-3, 3 là cấp cao nhất | Cấp càng cao thì rủi ro càng lớn |
| pushPrice | Giá đẩy vào lệnh | Giá tại thời điểm hệ thống lần đầu đẩy token cơ hội này | Dùng để tính mức tăng/giảm sau khi vào lệnh |
| gains | Mức tăng sau khi đẩy | (pushMaxPrice - pushPrice) / pushPrice * 100% | Mức tăng tối đa sau khi đẩy |
| declines | Mức giảm sau khi đẩy | (pushPrice - pushMinPrice) / pushPrice * 100% | Mức giảm tối đa sau khi đẩy |
| alpha | Tín hiệu Alpha | Giá trị boolean, biểu thị tiềm năng lợi nhuận vượt trội | Khi true nên chú ý cao hơn |
| fomo | Tín hiệu FOMO | Giá trị boolean, biểu thị tâm lý thị trường quá nóng | Khi true cần cảnh giác rủi ro đuổi giá |
| fomoEscalation | FOMO leo thang | Giá trị boolean, trạng thái FOMO leo thang thêm | Khi true rủi ro tăng đáng kể |
| active | Số địa chỉ hoạt động 24h | Số địa chỉ on-chain có giao dịch trong 24 giờ qua | Phản ánh mức độ tham gia thị trường |
| newly | Số địa chỉ mới 24h | Số địa chỉ lần đầu nắm giữ token này trong 24 giờ qua | Phản ánh dòng vốn mới vào |
| bullishRatio | Tỷ lệ tâm lý tăng giá | Phạm vi 0-1, dựa trên phân tích mạng xã hội | Càng gần 1 thì thị trường càng tăng giá |
| bearishRatio | Tỷ lệ tâm lý giảm giá | Phạm vi 0-1, dựa trên phân tích mạng xã hội | Càng gần 1 thì thị trường càng giảm giá |
| tradeInflow | Dòng tiền ròng giao dịch | Giá trị dương là dòng vốn vào, giá trị âm là dòng vốn ra | Giá trị dương liên tục cho thấy vốn chủ lực đang gom hàng |
Giải thích giá trị enum
tradeType - Loại giao dịch
| Giá trị | Ý nghĩa |
|---|---|
| 1 | Spot |
| 2 | Hợp đồng (vĩnh viễn) |
| 3 | Hợp đồng giao hàng |
timeParticleEnum - Độ chi tiết thời gian
| Giá trị | Ý nghĩa |
|---|---|
| 5 | 5 phút |
| 15 | 15 phút |
| 30 | 30 phút |
| 101 | 1 giờ |
| 104 | 4 giờ |
| 124 | 24 giờ |
| 201 | 1 ngày |
| 207 | 7 ngày |
| 230 | 30 ngày |
Ví dụ yêu cầu
json
{}Ví dụ cURL (Linux/macOS)
bash
curl --location --request POST 'http://${host}/api/open/v1/ai/getChanceCoinList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{}'Ví dụ cURL (Windows CMD)
cmd
curl --location --request POST "http://${host}/api/open/v1/ai/getChanceCoinList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{}"Ví dụ phản hồi thành công
json
{
"code": 200,
"message": "success",
"data": [
{
"vsTokenId": "23335", // Token ID
"symbol": "THE", // Ký hiệu token
"price": "0.2792", // Giá hiện tại
"maxPrice": "4.10318040169636", // Giá cao nhất
"minPrice": "0.07220387483514598", // Giá thấp nhất
"percentChange1h": "0.32799907", // Phần trăm thay đổi giá 1 giờ
"percentChange24h": "1.41729409", // Phần trăm thay đổi giá 24 giờ
"percentChange7d": "4.48765177", // Phần trăm thay đổi giá 7 ngày
"percentChange30d": "7.90282167", // Phần trăm thay đổi giá 30 ngày
"percentChange60d": "25.65261453", // Phần trăm thay đổi giá 60 ngày
"percentChange90d": "56.36890614", // Phần trăm thay đổi giá 90 ngày
"cost": "0.270901516998264831", // Giá chi phí
"costChange": "0.0625", // Thay đổi chi phí
"deviation": "-1.418662", // Độ lệch
"marketCap": "36026970.954971075", // Vốn hóa
"marketCapRanking": 312, // Xếp hạng vốn hóa
"circulatingSupply": "128932942.41721758", // Lượng cung lưu hành
"circulationRate": "39.535394", // Tỷ lệ lưu hành
"active": "347", // Địa chỉ hoạt động
"newly": "347", // Địa chỉ mới
"tradeType": 1, // Loại giao dịch (1: Spot 2: Hợp đồng 3: Hợp đồng giao hàng)
"chanceCoinTradeDataV1Vos": [
{
"timeRange": "m15", // Khoảng thời gian
"timeParticleEnum": 15, // Giá trị enum khoảng thời gian
"tradeInflow": "460.6252600000001", // Số tiền dòng tiền ròng giao dịch
"tradeAmount": "3213.5094600000007" // Tổng số tiền giao dịch
},
{
"timeRange": "m30",
"timeParticleEnum": 30,
"tradeInflow": "-338.09664999999995",
"tradeAmount": "4455.511570000001"
},
{
"timeRange": "H4",
"timeParticleEnum": 104,
"tradeInflow": "-5145.618659999999",
"tradeAmount": "37250.337159999995"
}
// ... bỏ qua thêm dữ liệu
],
"updateTime": 1773016500000, // Thời gian cập nhật
"pushPrice": "0.2621", // Giá đẩy
"pushMaxPrice": "0.2806", // Giá cao nhất sau khi đẩy
"gains": 0.0, // Mức tăng
"pushMinPrice": "0.2587", // Giá thấp nhất sau khi đẩy
"declines": 1.297215, // Mức giảm
"score": 45.0, // Điểm hiện tại
"scoreChange": 10.0, // Thay đổi điểm
"grade": 2, // Cấp
"alpha": false, // Có alpha hay không
"fomo": false, // Có FOMO hay không
"fomoEscalation": false, // Có FOMO leo thang hay không
"bullishRatio": 1.0, // Tỷ lệ tăng giá
"bearishRatio": 0.0 // Tỷ lệ giảm giá
},
{
"vsTokenId": "1831",
"symbol": "BCH",
"price": "471.1",
"maxPrice": "4355.6201171875",
"minPrice": "75.0753135706",
"percentChange1h": "-0.01774485",
"percentChange24h": "2.29847208",
"percentChange7d": "2.79498224",
"percentChange30d": "-7.7764893",
"percentChange60d": "-24.54350443",
"percentChange90d": "-18.72153828",
"cost": "292.505855607332520866",
"costChange": "2.446914",
"deviation": "-35.698867",
"marketCap": "9404123107.056818",
"marketCapRanking": 11,
"circulatingSupply": "20006718.75",
"circulationRate": "95.270089",
"active": "22924",
"newly": "22924",
"tradeType": 2,
"chanceCoinTradeDataV1Vos": [
{
"timeRange": "m15",
"timeParticleEnum": 15,
"tradeInflow": "-22417.999600000003",
"tradeAmount": "68195.44840000001"
},
{
"timeRange": "m30",
"timeParticleEnum": 30,
"tradeInflow": "-30667.368100000003",
"tradeAmount": "107622.5285"
},
{
"timeRange": "H4",
"timeParticleEnum": 104,
"tradeInflow": "-100288.20520000004",
"tradeAmount": "1847100.6466"
}
// ... bỏ qua thêm dữ liệu
],
"updateTime": 1773025800000,
"pushPrice": "450.1",
"pushMaxPrice": "475.6",
"gains": 0.0,
"pushMinPrice": "442.6",
"declines": 1.666296,
"score": 65.0,
"scoreChange": 10.0,
"grade": 1,
"alpha": false,
"fomo": false,
"fomoEscalation": false,
"bullishRatio": 0.5455,
"bearishRatio": 0.0
},
{
"vsTokenId": "23635",
"symbol": "FORM",
"price": "0.29",
"maxPrice": "4.190275115870975",
"minPrice": "0.14300383150589102",
"percentChange1h": "1.00325051",
"percentChange24h": "8.34645515",
"percentChange7d": "0.43961778",
"percentChange30d": "48.34304224",
"percentChange60d": "-22.25867739",
"percentChange90d": "0.63458821",
"cost": "0.939513805854359157",
"costChange": "-0.253266",
"deviation": "218.155708",
"marketCap": "112311811.6419909",
"marketCapRanking": 155,
"circulatingSupply": "381867255.144574",
"circulationRate": "65.839182",
"active": "164",
"newly": "164",
"tradeType": 2,
"chanceCoinTradeDataV1Vos": [
{
"timeRange": "m15",
"timeParticleEnum": 15,
"tradeInflow": "-70934.94349000002",
"tradeAmount": "132642.78527"
},
{
"timeRange": "m30",
"timeParticleEnum": 30,
"tradeInflow": "-75774.15476000002",
"tradeAmount": "167235.10643999997"
},
{
"timeRange": "H4",
"timeParticleEnum": 104,
"tradeInflow": "-87347.62276",
"tradeAmount": "371051.104"
}
// ... bỏ qua thêm dữ liệu
],
"updateTime": 1773027600000,
"pushPrice": "0.2829",
"pushMaxPrice": "0.3109",
"gains": 0.0,
"pushMinPrice": "0.2627",
"declines": 7.140332000000001,
"score": 55.0,
"scoreChange": 10.0,
"grade": 1,
"alpha": false,
"fomo": false,
"fomoEscalation": false,
"bullishRatio": 0.5,
"bearishRatio": 0.0
}
// ... bỏ qua thêm dữ liệu
],
"requestId": "xxx-xxx-xxx"
}